XferDb (tm) v1.12
----------------


XferDb lets you send or receive database records for NewtDB from a desktop (or other) computer.  It could even be used for Newton to Newton record exchange. Your desktop database should be able to export and import text records with a tab character as the field delimiter. Field order of the data should be the same as in NewtDb.


Requirements
------------

1. Serial cable:  XferDb supports serial data transfer. Appletalk is not supported. The serial cable that you use for NCK, NCU or NBU is the cable to use.

2. Desktop Computer: Any speed computer can be used.

3. Desktop computer software: You'll need a Terminal program. For sending records, you should be able to do a ASCII (or Text) send. To receive records, you'll need to be able to capture (ASCII / Text) incoming data to a file.

For Mac, Zterm or ClarisWorks are just fine. For PC's you can use ProComm, Windows 3.1 Terminal or Win95's Hyperterm. Just about any other one can be used too.

4. Handshaking, baud rate etc.: XferDb supports Xon / Xoff software handshaking, works at 9600 baud, no parity, 8 data bits and 1 stop bit. Hardware handshaking is not used. However, a hardware handshake cable is OK to use.

5. Data format: XferDb expects to get records that end in a carriage return. Line feeds are ignored. For separating fields  a tab is expected. This is the most common format of records when they are exported from database programs.

XferDb will translate received VT's (vertical tabs - FIleMaker uses them for inter-record lines) into CR's. The same is true when XferDb sends records.

You have the option of sending Line Feeds when transferring records from XferDb. Commonly, PC's use them, Mac's do not.

Before receiving records, be sure that you have the database defined and has the correct number of fields. Extra data sent is ignored. Conversly, you don't have to send every field. If enough fields are not received, the trailing fields are set to empty.

Controls and Usage
-----------------

1. Select which database to send / receive by pressing the Db# popup and selecting the database to use.

2. You may press the Records button anytime when idle to count the number of records in the database. The count is shown to the right of the button.

3. To send records, press the Send button. Before pressing it, set your terminal program to capture (receive) incoming data to a file. After all records are sent, stop the terminal programs receive / capture. You will know when all records are send as the main window will indicate. You may stop the transfer before all records are sent by pressing the Stop button. Be sure to check the Send <lf> option if needed.

4. To receive records, press the Receive button. Then start the text file send function from your terminal program. When all records have been sent, press the Stop button.


5. You may also press the Clear All button. It will delete all records in the selected database after confirming the action.

6. Sync is not yet implemented. 


Questions and comments to:

Dave Pompea
DMP Systems
62 Brittany circle
Rochester, NY 14618

email: 74736.172@compuserve.com

This program is bound under the general terms and conditions of NewtDb and programs in the NewtDb bundle. Copyright 1997, all rights reserved.

Version History:

V1.12 4/22/97  General public release.
Minor changes for verbiage, messages in status window.
Added check for NewtDB use (not yet implemented) of compressed index's.


V1.01 4/16/97 beta release to selected users.
Added Receive, Count, Clear functions.
Added internal support for compressed index's.

V1.0 4/7/97 beta release to selected users.
Send only implemented.


The Legal Stuff:
---------------- 
DISCLAIMER No warranty, express or implied, is made with respect to this software, including, without limitation, any implied warranties of merchantability and fitness for any particular purpose. I do not warrant that the function of the software will meet customers requirements, or will operate in the manner desired by customer or that the software shall be error free. I shall not, under any circumstance, be liable to customer or third party for any special, incidental, or consequential damages, including but not limited to the loss of data or information of any kind, loss of profit, or
liability to third parties, however caused, whether by the act or negligence, of use or inability to use or otherwise. It is recognized that the equipment this software is used on contains memories or  data or other things that may be valuable to the customer or a third party. In no event shall I be liable to the customer or any third party if any such data or memory or other things are lost or changed or destroyed, regardless of the cause of any such loss or change or destruction, directly or indirectly arising from customers use misuse or inability to use the software either separately or in conjunction with other equipment. 





Who owns this Software:
----------------------
The programs in this package is licensed, not sold to you, when you pay a Shareware fee of $29.95US. You have 45 days to evaluate the programs before you must decide to send the shareware fee or stop using it. The program remains owned by DMP Systems. The
program and documentation are Copyright  1994,1997 DMP Systems, all rights reserved. You may use the program only on one Newton at a time.  No copies of this software shall be made except for backup needs. If you transfer ownership of this software, all copies of this software shall be destroyed.  This software may not be disassembled , reverse engineered or altered. This documentation is copyrighted by DMP Systems and may not be reproduced or copied by any means including, but not limited to photocopier, computer, transcribed, verbal, or any other way. NewtDb and related programs were developed using the Newton Toolkit, which is Copyright  1992-1994 Apple Computer, Inc.  DMP Systems accepts no responsibility or liability for the product or what it might do to your Newton.  You use this program at your own risk!  Newton and NTK are registered trademarks of Apple Computer, Inc. 

"The Relational Database for Newton" is a Servicemark of DMP Systems.
NewtDb, UtilityDb, BarCodeDb, DemoDb and XferDb are  Trademarks of DMP Systems.

Product specifications and prices subject to change. Not responsible for typographic errors and omissions. 


